home *** CD-ROM | disk | FTP | other *** search
/ FM Towns: Free Software Collection 11 / FM Towns Free Software Collection 11.iso / t_os / tool / ptool / twist.doc < prev    next >
Text File  |  1995-08-15  |  6KB  |  142 lines
  1.  
  2.                  Polygon data handling TOOLs (for EAST-RAY)
  3.  
  4.  
  5.           　ポリゴン　ひねくりツール　for EASTRAY's Polygon Data
  6.  
  7.                 Polygon Twist  MS-DOS/DOS-Extender汎用版 V1.0
  8.  
  9.               Copyright(C) 1994  M.Satoh(MARIN/NIFTY:HBA00106)
  10.               
  11.    ORIGINAL (Quick Basic for PC-9801シリーズ版):
  12. 　    Copyright(C) 1994 by 張果老 こと Y.Fujita　( Nifty-Serve KHB00465 )
  13.  
  14.  
  15. ■はじめに
  16.  
  17.     このツールは先に張果老さん(NIFTY:KHB00465)が公開されたTWIST.EXEと機能的
  18.   に同じものです。張果老さんの物はQuickBASICで作成され機種依存コードを含む
  19.   実行形式になっていました。張果老さん自身の好意でソースも一緒に添付されて
  20.   いたため、許可をいただいて私がＣへ移植しMS-DOS/DOS-Extender汎用版として
  21.   公開することにしました。
  22.   
  23.     また、同時にこのツールはEASTRAYでサポートされるMONOLITH形式対応のポリゴ
  24.   ンデータを操作するものでもあることから、今まで拙作ツールしか無かったPTOOL
  25.   の一つとしても公開させていただく事になりました。
  26.   
  27.     この場を借りて、移植とPTOOLとしての公開のお許しを下さった張果老さんに
  28.   感謝の意を表したいと思います。ありがとうございました。
  29.  
  30.     なお、以降このMS-DOS/DOS-Extender汎用版の事を｢移植版｣, 張果老さんの物
  31.   を｢オリジナル版｣と呼ぶ事にします。
  32.  
  33.  
  34. ■使用法
  35.    ・形式
  36.    
  37.     Usage: twist [options] [file_name] [options]
  38.  
  39.    ・オプション
  40.    
  41.      移植に際して、他のPTOOL同様に実行時のオプションによって各パラメータを
  42.    指定できるように変更しました。なお、不可欠なパラメータで省略値を持たない
  43.    ものは、オプションで指定されていない場合メッセージを表示して値の入力を促
  44.    します。
  45.    
  46.      各パラメータの意味は、TWIST.ORG(張果老さんのオリジナルドキュメント)を
  47.    参照してください。
  48.    
  49.    --------------------------------------------------------------------------
  50.         file_name : 変換元のポリゴンデータファイル名を指定しする。省略すると
  51.                     入力を促される。
  52.                     なお、入力データは全て三角形に分割されている必要がある。
  53.                     
  54.         -o  fname : 変換後のポリゴンデータファイル名を指定する。これを省略す
  55.                     ると、コンソールに表示される。
  56.                     
  57.         -f        : オプション"-o"で指定されたファイルが既存の場合、このオプ
  58.                     ションを指定していると強制的に上書きする。指定されないと
  59.                     プログラムが聞いてくる。
  60.                     
  61.         -s  dim   : 傾斜次数を指定する。値は(-)1～(-)4の整数値であること。
  62.                     この値が正の値か負の値かは、"-p"オプションが省略された
  63.                     場合に意味を持つ。省略値は１。
  64.         
  65.         -p min max: ツイスト開始座標および終了座標を指定する。
  66.                     省略すると自動的に変数軸に対しての頂点データの最小値を
  67.                     開始座標, 最大値を終了座標として利用する。
  68.                     又"-s"オプションで傾斜次数に負の値が指定されている時は、
  69.                     逆に最大値を開始座標, 最小値を終了座標とする。
  70.                     
  71.         -c  x y z : 各軸に対するオフセット値を指定する。省略値は各値とも０。
  72.         
  73.    -[x/y/z][x/y/z]: ツイスト軸および変数軸を指定する。"-"に続いて１文字目が
  74.                     ツイスト軸で２文字目が変数軸である。"-xy"というような感
  75.                     じで指定する。省略すると入力を促される。
  76.                     
  77.         -a  angle : ツイスト角度を指定する。値は0～±3600で単位は[度]である。
  78.                     省略すると入力を促される。
  79.         
  80.         -H/h/?    : 簡単なオプションの説明が表示される。
  81.    --------------------------------------------------------------------------
  82.  
  83.    ・使用例
  84.    
  85.    >twist test1.pgn -o test2.pgn -xx -a 180 -p 550 -550 -s 4
  86.    
  87.    この場合、
  88.      ソースファイル名=test1.pgn
  89.      ソースファイル名=test2.pgn
  90.      ツイスト軸= X
  91.      変数軸= X
  92.      ツイスト角度=180.000000 [deg]
  93.      ツイスト開始座標= 550.000000 [X axis]
  94.      ツイスト終了座標= -550.000000 [X axis]
  95.      傾斜次数= 4 次
  96.      Ｘ軸オフセット= 0.000000
  97.      Ｙ軸オフセット= 0.000000
  98.      Ｚ軸オフセット= 0.000000
  99.    となります。
  100.  
  101.  
  102. ■オリジナル版との相違点
  103.  
  104.   張果老さんのオリジナル版との違いが幾つかあります。
  105.   
  106.     １．対応するポリゴンデータのファイル形式で、オリジナル版ではEASTRAYの
  107.       .RAY形式で必要な"<",">"を含んでいる必要があったが、移植版では必要無い。
  108.       逆に、"<",">"があるとリードエラーとなる。
  109.             ￣￣￣￣￣￣￣￣￣￣￣￣￣￣
  110.     ２．入力ポリゴンデータファイルの体裁に関しては、他のPTOOLに準ずるため、
  111.       基本的にコメントは自由に任意の位置に挿入する事を許す。２行にまたがる
  112.       形になっても構わない。
  113.       
  114.     ３．出力ファイルの中にパラメータ情報をコメントとして一緒に出力する機能
  115.       で、オリジナル版では履歴的に元データの分も残すが、移植版では現情報
  116.       のみ出力する。
  117.     
  118.     ４．「使用法」の項で書いたように、パラメータの指定方法をPTOOLに準ずるよう
  119.       変更している。
  120.     
  121.     ５．出力ファイルは明示的に指定する必要は無く、指定されなかった場合は
  122.       コンソールへ出力される。
  123.     
  124.     ６．ツイスト開始,終了座標はオプションにて指定されない場合には、入力を促す
  125.       のではなく自動的にプログラム内で座標値の最大最小値を求めて利用する。
  126.  
  127.  
  128. ■著作権，配付について
  129.  
  130.   このプログラム(移植版)の著作権は作者である私、佐藤雅弘(MARIN/NIFTY:HBA00106)
  131. が保有します。....と明言して良いのかどうか、実は私自身分かりません。(^^;)
  132.   ただし、冒頭にも書いたようにオリジナルの著作権は張果老さん(NIFTY:KHB00465)
  133. にあることに注意してください。
  134.  
  135.   また、その他制限事項に関してもオリジナル版に従うものとします。"TWIST.ORG"
  136. 中の【著作権その他】の項を参照するようお願いします。
  137.  
  138.   なお、このプログラム(移植版)の転載に関しては私にも連絡下さるようお願いし
  139. ます。
  140.  
  141.                             *** NIFTY:HBA00106 / 佐藤  雅弘 / M A R I N ***
  142.